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1. Introduction. 


This document describes the latest release of the Portable C Compiler (PCC). PCC represents the 
machine independent portion of the C compiler found on UNIX® systems. This release is identified 
as PCCr1.1. It encompasses revisions to the C language, as described in [1], bug fixes and various 
implementor enhancements over the last release. 


2. C Language Changes. 
2.1 Addition of Enumeration Data type. 


Enumerations are unique data types with named constants. They replace, in part, the use of #define 
constants, and offer the advantage of scoped constant names and strong type checking in the use of 
sucb names. As an example: 


enum color {red, green, yellow, blue); 


enum color *cp, col; 


col = yellow; 
cp = &col; 


if ( *cp == green) ... 


This example declares the identifier "color" to be the enumeration-tag of a type describing various 
colors, and then declares “cp" as a pointer to an object of that type and “col” as an object of that 
type. The role of the identifier is entirely analogous to that of the structure-tag in a struct-specifier; 
it names a particular enumeration. 


Objects of a given enumeration type are regarded as having a type distinct from objects of all other 
types. The compiler maps enumerations into the int storage class. 


A complete, formal specification can be found in section 8.5 of [1]. 


2.2 Structure and Union Assignment. 


Structure and union assignment was added to the C language to simplify both the source and object 
code used to transfer the value of one structure or union instance to another and to allow functions 
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to return aggregate values. Structure and union assignment also improves source program 
readability. 


Structures and unions may be assigned as a unit, passed as arguments to functions, or returned by 
functions. The types of all structure operands taking part in these operations must be the same. 


An example is as follows: 


extern struct point funcO; 


val = func0; 


This example will assign the structure returned by function "func" to the structure instance "val". 
2.3 Nomunique Strectare Member Names. 


In previous language specifications all symbol names, whether simple variables, structure and union 
members or typedef names, had to be unique throughout the program. The C language has been 
revised to permit the reuse of structure members or field names, except that a particular symbol 
may not be used for two distinct names in the same structure. These nonunique member names 
permit more natural structure and union member naming conventions and result in stronger type 
checking of both structure and union member references. 


This change should not cause any upward compatibility problems, as the following example will 
indicate: 


struct { 
short count; 
int sum; 
Ja; 
struct { 
char “ptr; 
long _ count; 


} b; 
we 


In previous compiler releases the above example would have been flagged as an error since the 
variable “count” was a declared once as short and then redeclared as a long. even though the 
declarations appeared in different structures. With the current release the nonunique variable name 
is allowed and must be uniquely described through the use of complete structure name qualifiers. 


2.4 Complete Stracture Qualifications are Required. 


A structure (union) member reference is a chain of member references, also known as qualifications, 
that are prefixed by a structure (union) or a pointer to one. Each qualification implies the addition 
of an offset within an address computation. Previous compilers allowed the omission of those 
qualifications with an offset of zero. That is, they failed to check if the variable was a member of 
the appropriate structure (union). 


An example of this is: 
struct { 
union { 
long ik; 
short [2]; 
) word; 
float f; 
i 
ptr = x1; 
ptr = x.sl0]; 


Prior to the language change these references were considered legitimate. However with the current 
release of PCC these will produce non-fatal error messages. The proper usage in the above example 
is: 


ptr = x.word.]; 
ptr = x.word.s[0]; 


2.5 Addition of Type Specifier Void. 


This release of the compiler introduces a new type specifier, void. The void type specifies an empty 
set of values. It should be used as the type returned by functions that generate no return value. 


An example of its use is as follows: 


void error (str) 
char “str; 
{ 
printf("Error: %s\n", str); 


(void) error("missing variable"); 


In this example there is no value returned from the function error. This is explicitly specified by the 
use of the void specifier on the function calling line. 


Functions that have no return type defined act the same as in the past, that is they default to int. 


2.6 Old Style Initialization Removed. 


The old style of variable initialization is no longer accepted by the compiler. Any code that relies on 
this feature will produce a fatal diagnostic when recompiled with the latest compiler. A common 
class of user syntax errors caused the compiler to incorrectly generate initialization code with 
undesirable effects (e.g., core dumps) and inappropriate diagnostics. 


An example of such initialization follows: 


long «x (1; 
int f Q); 


The correct syntax for this example is: 


| long x= 1; 
int f = (2); 


2.7 Old Style Assignment Operators Removed. 


Old style assignment operators have been removed from the C language. This release will flag their 
use as a fatal error and produce an appropriate message. Earlier versions of C allowed the form 
op instead of op™ for assignment operators. 


Examples of such assignment operations are: 


a =+5; 


x =-]; 


The *=+" is now a syntax error and will be flagged by the compiler. The compiler also flags the 
*=—" due to its ambiguity with the assignment of a negative value. In the old semantics this 
operation would imply that a 1 should be subtracted from the variable x. However, in the next 
release of the compiler the interpretation will be to assign the constant (—1) to the variable x. 


28 Octal 8 and 9 Produce Warning Message. 


The use of digits 8 and 9 as octal numbers is no longer part of the language. In previous releases 
the compiler accepted the digits 8 and 9 in octal constants. As of this implementation 8 and 9 will 
be flagged with a warning message when they appear in octal constants. The compiler will convert 
the appearance of an 8 or 9 into an octal 010 or 011, respectively. Arithmetic will be performed to 
add the carry to the next significant digit. Future releases will make such usage a fatal error. 


An example of this is: 


x = 029; 


The compiler will produce a warning and treat the constant as if it was (020 + 011) = 03). & 


_3. Bag Fixes. 


Various enhancements and bug ,fixes were done to the compiler since System HJ. Numerous 
modification requests revealed many bugs that were identified and corrected. This document will 
not attempt to address every change that occurred since the last release but merely highlight the 
ones that are most likely to be observed. 


3.1 Pointer to Fumction Returning Ved. 


Additional type checking code has been added to the compiler to allow pointer to a function that 
returns void. A declaration of such is: 


void (*)0; 


3.2 Access to a Member of a Returned Structure or Unica. 


Now that the language allows structure and union assignments a bug was uncovered in the compiler 
regarding the immediate access of members of the returned structure or union. 


An example of such a construct is: 
x=fO0a; 


where fQ is a function returning a structure that has a member element of “a”. 
This bug has been identified and removed from the compiler. 
3.3 Coaversion Code for Assignmeat Operators. 


PCC now produces the correct type conversion code for assignment operators embedded in 
expressions. All questionable code which relied upon incorrect boundary handling should be re- 
examined. A common example of such incorrect coding is shown below: 


char ch; 


while ( (ch = getcharO ) != EOF ) 


The EOF is defined to be a negative integer constant while the expression on the left of the "!= ° is 
an unsigned character. The EOF returned by getchar0 has been converted from an integer to a 
character value and no longer acts like the original EOF. To correct this example, the variable “ch" 
should be declared as an integer. 


3.4 Parameters iz Function Declarations. 


A serious bug was uncovered when parameters were inadvertently placed into function declarations. 
An example of such is: 


short func(x, y); 


Here the user is simply declaring the function “func” to return a short, not actually defining the 
body of the function. In this case the variable arguments “x” and “y" represent syntax errors. The 
compiler now checks for this and reports it as a fatal error. 


3.5 Constants. 


3.5.1 The tests to determine when constants become long integers have been changed to conform to 
the C Reference Manual. A problem existed with these tests in a cross-compiling environment 
where the size of int and long were different on the host and target machines. 


5.5.2 Constant folding of long constants has been fixed. In some constant expressions involving long 
constants the correct type (long) was not given to the result. 


3.5.3 Constant folding of unsigned constants has been fixed. The latest compiler implemented the 
language specification that sizeof returns an unsigned quantity. Since there was no knowledge of 
wasigned constants in the routine that does constant folding, the unary operators negate ("—") and 
complement ("~) sometimes produced the wrong results when applied to the value returned by 
sizeof. 


3.5.4 Tegal hexadecimal constants are no longer allowed. Previous releases of the compiler had a 
bug in the code that checked for hex constants. The bug would allow such expressions as: 
i = 010x; 


as a valid hex constant when the value 0x10 was intended. 
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